iiinianiiiiiiiiiiiiiiiiiiii 

US005 146593 A 

United States Patent [19] [ii] Patent Numben 5,146,593 

Brandle et al. [45] Date of Patent: Sep. 8, 1992 



[54] PROCEDURE CALL INTERFACE 

[75] Inventors: Richard T. Brandle, Marietta; Don L. 

Goodliffe, Dun woody; Donald E. 
Keith, Peachtree City; Randy A. 
Robin ette; Robert C Slzemore, both 
of Acworth; Garry J. Smith wick, 
Alpharetta; Anthony J. Zappafigna, 
Marietta, all of Ga. 

[73] Assignee: International Business Machines 
Corporation, Armonk, N.Y. 

[21] Appl. No.: 320,086 

[22] Filed: Mar. 6, 1989 

[51] IntQ.5 G06F 12/04 

[52] VS. CL 395/700; 364/DIG. 1; 

364/280.4 

[58] Field of Search 364/200; 395/700 

f BEGIN ) 



[56] References Cited 

U.S. PATENT DOCUMENTS 



4,205,371 5/1980 
4.455,604 6/1984 
4,712,189 12/1987 



Feather 364/DIG. 1 

AhJ strom et al. 364/DIG. 1 

Mohri - 364/DIG. 2 



Primary Examiner— Thomas M. Heckler 
Attorney, Agent, or Firm— Kenneth C. Hill 



[57] 



ABSTRACT 



A system software interface is provided which is called 
by applications programs using a standard format. All 
calls to system library routines are made through this 
interface. When called, the interface determines the 
location and original language of a desired library pro- 
cedure. The interface then sets up parameters and calls 
such procedure using the calling convention which it 
expects. The interface receives any results generated by 
the library procedure, converts them to the return con- 
vention used by the calling application, and returns the 
results to the calling application. 

10 Claims, 2 Drawing Sheets 
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without adversely affecting any applications program 
PROCEDURE CALL INTERFACE which might call such procedure. 

BACKGROUND OF THE INVENTION SUMMARY OF THE INVENTION 

1. Technical Field 5 !t te « ? f *f I™« inyentkm to 

tk^ ««*«it i« W nti«« r»i.»~ rmmi\v » rt orvmn,,^ provide a computer system interface which allows pro- 

TTie present invention reUtes generally to computer * ^ procedures without re- 

7r^fLT C SPCClfiCal,y l ° tCChnK,UCS f0f makUlg £Tto calling convention^ by the language in 

5r5aSforrt H Art which such procedures were originally written. 

Pr^ilS™ i.™„««~ «^«h» <mim« f«r 10 ^ «« also an object of the present invention to provide 

*k* - system interface which allows changes to be 
procedure calls, whereby code which i"cuuMe can be jQade ^ yb routines without adversely affecting 
placedm a defined location and ex^tedwhen needed. haaioas ^ which call such procedures. 
Parameters can be passed to called procedure^and b a ^ ofthe pmcnt mvcntjon to allow 
results returned. As used herein, the term procedure ]5 A Ub procedure to be used on a system for 
will be used in a generic sense; program segments which function, and to allow such procedures to 
are referred to inj particular be rewritten in any language without regard to any 
functions, and subroutines will all be referred to herein differences which may exist in procedure calling con- 
as procedures, ventions. 

Details of procedure calling conventions differ with „ according to the present invention, a sys- 

different programming languages. Some parameters ^ ioftw3Tt interface * provided which is called by 

may be passed in registers, on a procedure stack, or m wlications programs using a standard format. All calls 

memory blocks pointed to by pointers held in a register to tcm library routmcs m made through this inter- 

or a stack location. Because of different calling conven- face . when called, the interface determines the location 

tions used by different languages, procedure calls must 25 and C3nin$ convention used by a desired library proce- 

be made to procedures originally written in the same dure . interface then sets up parameters and calls 

language, or another language using the same calling such proC edure using the calling convention which it 

conventions. If it is desired to make a call to a procedure expects. The interface receives any results generated by 

originally written in a different language, and the iden- the library procedure, converts them to the return con- 

tity of the original language is known, special steps can ^ vcn tion used by the calling application, and returns the 

sometimes be taken to restructure the call to function rcsu jts to the calling application, 

correctly with such procedure. This restructuring usu- 

ally requires modification of the call at the assembly BRIEF DESCRIPTION OF THE DRAWINGS 
language level. The novel features believed characteristic of the in- 
to many computer systems, including virtually all 35 vention are set forth in the appended claims. The inven- 
large and medium size systems, common libraries of tion itself however, as well as a preferred mode of use, 
procedures are maintained for standard and often used and further objects and advantages thereof, will best be 
functions. These procedures are called from application understood by reference to the following detailed de- 
programs, freeing an applications programmer from scription of an illustrative embodiment when read in 
writing and debugging code to perform common func- 40 conjunction with the accompanying drawings, wherein: 
tions. Depending on the system design, library functions FIG. 1 is a block diagram of a system for calling 
can be linked to an application program at link time, or library procedures according to the present invention; 
they may be dynamically linked at execution time if this FIG. 2 is a diagram illustrating a format for calling 
is supported by the operating system. library routines; and 

The language calling convention problem described 45 FIG. 3 is a flowchart illustrating steps taken to call a 
above exists with the use of procedure libraries. A li- library procedure, 
brary procedure must typically be written in each lan* TM^c^nTiyr™ 
guage supported by the system, so that multiple proce- DE nl^n^^m^^ 
dures exist for performing the same library function An PREFERRED EMBODIMENT 
alternative is to have one or a limited number of proce- 50 The software system described herein is suitable for 
dures written in a particular language, and require ap- use with nearly any general purpose digital computer, 
plications programmers to perform whatever steps are Mainframes, minicomputers* engineering workstations, 
necessary in order to call procedures written in differ- and many desktop personal computers can support the 
ent languages. system described below. Only minor modifications, 
Requiring that a system maintain multiple proce* 35 within the ability of those skilled in the art, are needed 
dures, written in different languages, for performing a for various existing language compilers as will be de- 
single common function is inefficient Forcing applica- scribed below. 

tions programmers to undertake steps necessary to call Referring to FIG. 1, a system 10 for handling library 

a procedure which uses a different calling convention is procedure calls includes a service director 12. The ser- 

not always possible, and is clearly undesirable even 60 vice director 12 is a software procedure which is called 

where possible. by a stub procedure 14. The stub procedure 14 is part of 

It would therefore be desirable for a system to pro- an application program 16. 

vide the ability for applications programs to call library The service director 12 contains several procedures 

procedures without regard to the calling conventions which define internal services 18. The service director 

used by the language the procedures were originally 65 12 also has access to data structures which define ser- 

written in. It would also be desirable for such a system vice tables 20. While executing, the service director 12 

to provide the ability to change library procedures, can make procedure calls to library procedures 22, 24, 

including changing the language they are written in, 26, and 28. 
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The application program 16 can perform any end use example, data and pointers can be moved from registers 

or system function, and is typically written in a high to a stack, and vice versa 

level language such as C or COBOL. Decreasingly, the In a preferred embodiment, an application must make 

application 16 may be written in assembly language. an initialization call to the service director 12 prior to 

The stub procedure 14 is a small procedure which is 5 invoking any system library procedures. This call passes 

linked to the application 16 at link time. parameters which identify the application, and allow 

The stub procedure 14 is called in the manner of any the service director 12 to locate the appropriate service 

other procedure by the application 16. Parameters tables 20. Different applications may use different sets 

passed to the stub procedure 14 describe a system li- of service tables. This call can also provide a pointer to 

brary procedure, or service, whose execution is desired. 10 a common control block who's function will be de- 

The stub procedure 14 uses these parameters to make a scribed in connection with FIG. 2. 

procedure call to the service director 12. It is also preferable for the application 16 to make a 

Since different programming languages use different termination call to the service director 12 after all calls 

procedure calling conventions, a different stub proce- to library procedures are completed. This allows the 

dure 14 must be provided by the system for each pro- 15 service director 12 to free allocated areas of memory, 

gramming language supported. However, a single stub and generally clean up after the application 16. 

program 14 makes all calls to the service director 12 for FIG. 2 illustrates a typical command for use within 

all desired library services. the application 16 for invoking a library procedure. A 

The service director 12 is the interface used by appli- command line 40 is a call to a stub procedure 14 having 

cation programs 16 when library procedures are called. 20 a stub procedure name 42. In some languages, such as 

The service director 12, when called, examines the FORTRAN, the word CALL actually appears as part 

parameters passed to it and determines which library of the statement invoking the stub procedure 14. In 

procedure is to be invoked. Certain procedures are many other languages, the work CALL is not used, and 

preferably included directly in the code of the service the stub procedure 14 is invoked merely by using its 

director 12. These procedures can be referred to as 25 name 42. 

internal services 18, or environmental services. These The stub procedure name 42 is preferably relatively 

procedures 18 are typically those which are executed arbitrary, so that it tends to not conflict with the use of 

often, and are not of great complexity. Efficient calls to descriptive procedure names. In order that a system 

these procedures 18 are preferred in order to prevent linker will be able to link in the stub 14 appropriate to 

system performance degradation. Typical system ser- 30 the language of the application program 16, the stub 

vices which can be included as internal services 18 to procedure name 42 indicates which language is being 

the service director 12 include program and storage used. In FIG. 2, a - is shown, and this _ is preferably 

management, time of day and similar systems services, replaced by one or more characters indicating the lan- 

and initialization and control routines directed toward guage being used. For example, these characters could 

operation of the service director 12 itself. 35 be "C\ "CBL" (for COBOL), or "ASM" (for assembly 

When an application 16, through the stub 14, calls the language). In the alternative, the same stub procedure 

service director 12, a procedure to be performed is name is used for all languages, and each compiler identi- 

identified by parameters passed thereto. Once the de- fies the appropriate stub procedure 14 by placing the 

sired procedure is identified, the service director must necessary external linkage information in the object file 

determine where the procedure is stored in the system, 40 it creates when it compiles the application program 16. 

what parameters it requires, and the language the proce- The first parameter passed to the stub procedure 14 is 

dure was originally written in. This last item indicates a service parameter 44, which is a pointer to a data 

the procedure calling convention which must be used structure called a service name block 46. The second 

when the desired library procedure is invoked. The parameter to be passed is a common block identifier 48, 

service director 12 finds this information from the ser- 45 which contains a pointer to a common block 50. The 

vice tables 20. The service tobies 20 are data structures third parameter 52 is a pointer to a procedure block 54, 

which provide a mapping from the names of system and additional parameters 56 are each pointers to sepa- 

library procedures to the information just described, rate parameter blocks 58. 

and can be implemented in any of several well known The parameters 52 and 56, shown in square brackets, 

data structures. 50 are optional in some cases. That is, some internal service 

Once the service director 12 has identified the library calls, such as time of day, may require only the parame- 
procedure to be invoked, it arranges any parameters to ters 44 and 48, depending upon implementation, 
be passed thereto appropriately for the calling conven- The service parameter 44 points to the service name 
tion expected by the procedure, and then calls it. Any block 46, which is an allocated block of memory con- 
results returned by the procedure are passed to the 55 taining several different items of information. The num- 
service director 12. If necessary, the service director 12 bers shown in block 46 indicate a number of bytes 
reformats the results, and returns them to the stub pro- which that field occupies. In the preferred embodiment, 
cedure 14. the first field in the service, name block 46 is a 

In many instances, an application program 16 and a LENGTH field, which indicates the total number of 

called library procedure will be written in the same 60 bytes in the service name block 46. The next field is a 

language, so that little difficulty is encountered in mak- NAME field, which is the name of a service. A PARM 

ing the required procedure calls. In other cases, an COUNT field indicates the number of parameters 

implementation of one language may pass parameters which are to be passed to the called service. This count 

and return results in registers, while an implementation is used to determine whether a procedure parameter 52 

of another language could use a stack. The service di- 65 is being passed, and how many parameter items 56 are 

rector 12 "knows- what is necessary to translate be- being passed. 

tween one calling convention and another, and makes A FLAGS field is used to pass information from the 

these changes in a fairly straight forward manner. For stub procedure 14 to the service director 12. One type 
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of information typically passed is the identity of the tify at least a service and common block, and optionally 
calling language. All of the stub procedures 14 for dif- a procedure identifier and parameters if required. The 
fereni languages call the service director 12 at the same stub procedure then sets a calling language flag 72. This 
entry point, and the FLAGS Held in the service name flag indicates to the service director 12 the program- 
block indicates to the service director 12 which calling 5 ming language of the application program 16, thereby 
convention is being used. indicating which calling conventions are used by the 

The INDEX field is used to more quickly identify the application 16 and stub procedure 14. 
location of information about a particular service. The The stub procedure then calls the service director 74, 
first time a service is invoked, the service director 12 which determines if the request is for an interna) service 
must search through the service tables 20 in order to 10 76. If the requested procedure is not internal to the 
match the NAME field with the various names avail- service director 12, the service director 12 locates the 
able in the tables 20. Once this match has been made, the desired procedure in the service table 78. As described 
service director 12 places the address of that entry in above, the service table entry indicates that information 
the tables 20 into the INDEX Meld. Whenever various necessary for the service director 12 to properly call the 
functions of this service are called in the future, this 15 requested library procedure. 

address is used to access the appropriate entry in the The service director 12 then sets up the parameters to 
service tables 20 directly. call the library procedure. A call to a library procedure 

The common block 50 is used by the service director requires conversion of parameters from the format used 
12 to return status and other information to the applica- in the language of the application program 16 to one of 
tion program 16. A LENGTH field indicates the size of 20 the formats used by the languages of the service proce- 
the common block 50. A RETURN CODE field is used dure 22-28. A conversion procedure (steps 801-808} 
to return status codes to the application program 16. By provided by the service director 12 is a generalization of 
convention in a preferred embodiment, a positive value techniques known in the art for calling a procedure 
for the return code simply passes through any return written in a known, but different language than that of 
code generated by the called library procedure. Also by 25 an application program. See for example the "IBM 
convention, a negative value for a return code is used by C/370 Users Guide", Chapters 31-36, Document No. 
the service director 12 to indicate a failure within its SC 091264-03 available from the International Business 
area of responsibility. Such failures could includes, for Machines Corporation, "OS PL/I Version 2 Program- 
example, the inability to locate a desired library proce- ming Guide", Chapter 17-20, Document No. SC 
dure. The EXTENDED CODE field provides an addi- 30 264307-01 available from the International Business 
tional ability to return error codes. Machines Corporation, or "VS COBOL II Application 

The ADDITIONAL ELEMENTS fields are op- Programming Guide", part 2, page 142, Document No. 
tional, and may be used to transfer data or pointers to SC 264045-03, available from the International Business 
data back to the application program 16. Machines Corporation. 

In addition to the LENGTH field, the procedure 35 Three types of operation are considered: (1) conver- 
block 54 includes a FUNCTION CODE field. This sion of parameter arrays between column major order 
field is a number indicating which function of a service and row major order; (2) establishment of a global envi- 
is desired. ronment; or (3) rearrangement of parameters between 

In a preferred embodiment, it is anticipated that re- call by value and call by reference. Need for each of the 
lated functions will be grouped together, and this 40 basic types of operations are determined at steps 
grouping is called the service. In order to access one of 801-802, 804 and 807. At steps 801 and 802 it is deter- 
these procedures, a name applied to the service as a mined if noncompatible arrays are present in the source 
whole is required, and is found in the service name language of the application program and the destination 
block 46, and an indication of which procedure within language of the procedure. If yes, the arrays are con- 
trie service is requested is found in the procedure block 45 verted from the source language format to the destina- 
54. For example, a group of routines for performing tion language format (step 803). An example of such a 
matrix manipulation can be identified by a single ser- conversion would be that between column major order 
vice, with the procedure block 54 indicating whether and row major order. From step 801 (YES branch), step 
calculation of a determinant, matrix multiplication, in- 802 (No branch), or step 803, step 804 is next executed, 
version, or other matrix manipulations are requested. 30 A destination language may require establishment of a 

Each parameter block 58 is used to transmit one pa- so-called global environment If a global area is re- 
rameter to the requested library procedure. The SER- quired (step 804) and has not been previously estab- 
VICE DATA field in the parameter block 58 can con- lished (step 805) it is established at step 806. From the 
tain the data directly, or can contain a pointer to the NO branch of step 804, the YES branch of step 805, or 
data. The type of data contained in each parameter 55 step 806, step 807 is next executed. Certain languages 
block 58 is dependent upon what each individual library have standard formats for passing parameters between 
procedure expects, and will be specified in the docu- programs written in the languages. If this is not avail- 
mentation for that particular library procedure. able (step 807) parameters are rearranged to a new for- 

FIG. 3 illustrates the steps which occur during a call mat for the destination language, (step 808). An example 
of a library procedure by an application program 16. 60 of a difference allowed for between the languages is 
The flowchart of FIG. 3 assumes that any initialization "call by value** and "call by reference.** Once the forgo- 
calls which need to be made to the service director 12 ing operations are completed, service direction 12 is 
have already been made. FIG. 3 illustrates only the ready to call the appropriate service procedure 22-28 
sequence of events which occur during a single call to a and calls it 82. The service procedure executes in its 
library procedure. 65 normal manner 84, and returns any generated results to 

First, the application program 16 calls the stub proce- the service director 66. 
dure and passes parameters to it 70. These parameters, The service director 12 sets up its return parameters 
as described in connection with FIG. 2, preferably iden- 88 to match the calling convention of the application 



05/25/2004, EAST Version: 1.4.1 



5,146,593 

1 8 

program 16 as indicated by the flag set in step 72. The a data structure defining a map for converting be- 

results are then returned to the stub procedure 90, tween an expression of parameters in conformance 

which in turn returns them to the application program with the first calling convention and an expression 

92. of parameters in conformance with the second 

In step 76, if the service director 12 detects that an S calling convention; 
internal service is requested, it executes such internal means for generating a procedure call in the applica- 
procedure 94 and goes to step 90. The service director tion program, the procedure call having an expres- 
12 understands the parameter passing mechanism used sion of parameters and an identification of the see- 
by the application program 16 because of the calling ond programming language; and 
language flag set in step 72, and can handle any required 10 means responsive to the procedure call for accessing 
translation directly. the data structure, for converting the expression of 

The system and method described above allows sys- parameters from the procedure call into a recxpres- 

tem library procedures to be written in different pro- sion of the parameters in conformance with the 

gramming languages. If a particular programming lan- second calling convention and for generating a 

guage is most appropriate for writing a particular de- 15 procedure call including the reexpression of the 

sired library procedure, that language can be used. Only parameters to the selected procedure written in the 

a single horary procedure need be maintained to per- second programming language, 

form a given function, allowing for greatly improved 2 A computer system for processing proce- 

mamtainability of system library procedures. If particu- durc c ^ s ^ ^ fortn m daim i : 

lar procedures are added or deleted, or some procedure 20 wn erein the selected procedure returns a result to 

rewritten in a language using a different calling conven- ^ VT0Ct A me ^ responsive means, and wherein 

tion, such updated information is simply reflected in the ^ p^^^e ^ responsive means is responsive 

service tables. This means the service director itself to mc re8ult for accessing the data structure and 

need not be modified, with the only modification neces- converting result parameters to the first calling 

sary for a change in a library procedure being an update 25 convention of the application program, 

to the service tables. TTus change is easily made by 3 Thc m QfcMm ^ further ^p^g; 

updating the service tables directly through the use of a a of hcAtion programs , each including 

program which performs table updating. mean5 f or calling said procedure call responsive 

Since the library procedure* urtd^c^\y^ t ^ for posing a procedure identifier and 

application program executables remain small. In addi- 30 Barometers thereto 

tion, applications always invoke the current version of a £^ ystcra of claim 3( whc rebi each of said appli- 

library procedure^ since links to particular procedures *™ a procedure callable using a 

are not maintained directly in the application programs. pivgiwua ^»uu» a F .^«uu.« 6 

The service director is located hVa known location standard format^ and wherein said mcluded procedure 

within the system, and is available io all applications 35 ^ said procedure call 

which need to make service calls. Therefore, changes procedure identifier, parameters, andan ^x^n 

can also be made to the service director without affect- of 8 proced*" calling convention used by said apphca- 

ing any application programs. «" P™*™ to ^d procedure call responsive means. 

The only restrictions imposed on operation of the 5. The system of claim 2: 
library procedures are the typical ones needed to ensure 40 therein said procedure call responsi ve means re- 
system and data integrity. The library procedures can reives a procedure identifier from the procedure 
be simple blocks of commonly used code, such as float- «d» from M application program and accesses said 
ing point libraries or database servers, or they can be dato structure to determine the corresponding 
more complex functions. Library procedures can per- ^ information. . 
form input and output, and interface directly with a user 45 * The system of claim 5, wherein the needed tnfor- 
for the application program. The library procedures can mation includes a location for the selected procedure, 
invoke other library procedures, or other programs or * The system of chum 5, wherein said procedure call 
systems. Invocation of other library procedures can be responsive means include a plurality of procedures call- 
made directly or through the service director as does an internally within said procedure call responsive 
application program. Library procedures can also be 50 means, and wherein an internally callable procedure is 
used to manipulate hardware directly, such as for pur- called when such internally callable procedure com- 
poses of real time data collection and control. sponds to the received procedure identifier. 

While the invention has been particularly shown and *• A method in a digital computer system of process- 
described with reference to a preferred embodiment, it ing procedure calls from an application program writ- 
will be understood by those skilled in the art that van- 55 ten in a first programming language to any selected one 
ous changes in form and detail may be made therein of a plurality of procedures, at least a first of which 
without departing from the spirit and scope of the in- procedures is written in a second programming lan- 
vention. guage, wherein the first programming language utilizes 

We claim: * first calling convention and the second programming 

1. A digital computer system for processing proce- 60 language utilizes a second calling convention, the 

dure calls from an application program written in a first method comprising the steps of: 

programming language to any selected one of a plural- generating a procedure call from the application pro- 

ity of procedures, at least a first of which procedures is gram, the procedure call having an expression of 

written in a second programming language, wherein the parameters and identifying the selected procedure 

first programming language utilizes a first calling con- 65 and the second programming language; 

vention and the second programming language utilizes providing a data structure defining a map for con- 

a second calling convention, the digital computer sys- verting between an expression of parameters in 

tem comprising: conformance with the first calling convention and 
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an expression of the parameters in conformance 
with the second calling convention; and 
responsive to the procedure call from the generating 
step, accessing the data structure and responsive 
thereto, converting the expression of parameters 5 
from the procedure call to a reexpression of the 
parameters in conformance with the second calling 
convention for the second programming language, 
and generating a procedure call including the reex- 
pression of parameters to the selected procedure. 10 
9. The method of claim 8 t further comprising the 
steps of: 



10 

returning result parameters from the selected proce- 
dure using the second calling convention; and 

converting the result parameters to the first calling 
convention. 

10. The method of claim 8, further comprising the 
steps of: 

after said generating step, determining whether a 
selected procedure can be executed internally to 
the accessing step; and 

if the selected procedure can be so executed, execut- 
ing the selected procedure internally. 
• • * * • 
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